package com.vegetable.modules.service.stock;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.vegetable.common.utils.PageUtils;
import com.vegetable.modules.entity.stock.StockAlert;
import com.vegetable.modules.entity.stock.po.StockAlertQueryPO;
import com.vegetable.modules.entity.stock.po.StockAlertSavePO;

import java.util.List;

/**
 * <p>
 * 库存预警设置表 服务类
 * </p>
 *
 * @author wangruijie
 * @since 2024-09-09
 */
public interface IStockAlertService extends IService<StockAlert> {

    /**
     * 分页查询库存预警设置
     * @param po 查询条件
     * @return 分页结果
     */
    PageUtils queryPage(StockAlertQueryPO po);

    /**
     * 新增或更新库存预警设置
     * @param po 预警设置对象
     * @param userId 操作用户ID
     * @return 操作结果
     */
    boolean saveOrUpdateAlert(StockAlertSavePO po, Long userId);

    /**
     * 根据商品ID和规格ID查询预警设置
     * @param commodityId 商品ID
     * @param specsId 规格ID
     * @return 预警设置
     */
    StockAlert getAlertByCommodityAndSpecs(Long commodityId, Long specsId);

    /**
     * 批量启用/禁用预警设置
     * @param ids 预警设置ID列表
     * @param isEnabled 是否启用：0否1是
     * @return 操作结果
     */
    boolean batchUpdateEnabled(List<Long> ids, Integer isEnabled);

    /**
     * 检查库存是否需要预警
     * @param commodityId 商品ID
     * @param specsId 规格ID
     * @param currentQuantity 当前库存数量
     * @return 是否需要预警
     */
    boolean checkStockAlert(Long commodityId, Long specsId, Integer currentQuantity);

    /**
     * 执行库存预警检查（定时任务调用）
     */
    void executeStockAlertCheck();
}